home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / net / anos_tools.lha / AmigaNOS-Utilities.doc (.png) next >
ANSI Art File  |  1993-12-05  |  9KB  |  640x3488
Labels: text | screenshot | font
OCR: Legal Mumbo Jumbo: These AREXX programs and documentation are Copyright 1993 by Dan Roman. Permission is granted to redistribute and use or modify the same as FREEWARE. Please credit me if you use my work and I'd like to see the results of any improvements or modifications you make. The only warranty is "It works for me.' How to contact the author: My amateur call sign is NZMFC and I can be reached at the following addresses (in order of preference): Internet as romanetix. timeplex.com 2) or D. ROMAN1@genie. geis.com 3) GEnie as D. ROMAN1 4) Amateur radio TCP/IP as n2mfc/n2mfc@w2nv.ampr.org 5) Amateur radio AX.25 BBS as n2mfc@n2imc.#nnj. nj. usa. na What's in here and what does it do? Contained in the archive with this documentation you should find the following files which pertain to using AmigaNOS for amateur radio TCP/IP: AmigaNOS-Utilities.doc What you are reading now. SendMail.rx AREXX program to allow various versions of ELM to work with AmigaNOS. Announcer .rx A little gizmo which allows you to let people page you or run programs on your Amiga by sending mail to your Amiga. Why did I choose to use AREXX over C? First, not everyone has a C compiler and AREXX comes standard with the AmigaDOS. There is lot of room for variation from system to system especially among amateurs using AmigaNOS, AREXX allows the user to customize these routines for use with his specific needs. Second, AREXX allows for very quick development of routines like these. Speed is not critical and AREXX handles the job quite nicely. This was a nice little job that did not justify C and if C was the only way to do it I probably would not have invested the time to do Setting up SendMail: The instructions below assume you are using AmigaELM version 1.17 by Andreas M. Kirchwitz ( Internet address amk@zikzak. in-berlin.de). There are other version of ELM available and although none are tailored to amateur radio specifically and therefore have many drawbacks, this one does work fairly well. 1) You need to make the following two aliases which your shell running ELM can use: alias sendmail rx SendMail.rx alias rmail rx SendMail.rx AmigaELM calls either sendmail or rmail (depending on whether or not it is doing a reply) and feeds it the email message from stdin. Aliasing the AREXX execution allows sendmail.rx to take stdin and process it. You must have the assignment for ELM's uumail: pointing to your AmigaNOS Spool/Mail directory. The following ELM parameters should be set in the ELM uulib: Config file. I use my call, NZMFC in all examples. ELM parameters which I have not listed are unimportant to SendMail. NodeName n2mfc UserName n2mfc. txt RealName Dan Roman DomainName .ampr.org DefaultNode n2mfc 1) The following ELM parameters be set in the ELM uulib :. elm/elmrc file. ELM parameters which I have not listed are unimportant to SendMail. SendmailVersion `eu Iner 5) You must edit two lines in the beginning of SendMail.rx to assign the variables mailhost and stationcall. See SendMail.rx for more information. NOTE: SendMail uses the T: directory for temporary files. Using SendMail: When you send or reply to a mail message using ELM, ELM will call the SendMail.rx AREXX program. You must however be aware of several things in the use of ELM which affect SendMail. ELM is hot 100% clean in these respects. 1) The To: line should contain only one address, multiple addressees are not supported. SendMail simply passes on addressing to AmigaNOS for the smtp command to use. It creates files in the AmigaNOS Spool/MQueue directory and updates the file sequence. seq as necessary. Provisions are made within SendMail to allow up to 10 cc: address to be placed on one line and 10 bcc: addresses to be placed on one line. Place these lines after the To: line and before the Subject: line. For example: To: ron Cc: bill steve ka9q@ucsd.edu bcc: joe john glyyheg1yyh.ampr.org Subject: Test of sendmail. SendMail creates individual files for AmigaNOS smtp to process for each recipient. 3) This has nothing to do with SendMail really but is important for using ELM. You must leave a blank line in between the header information (usually the Subject: line) and the body of the text. Otherwise, ELM on receiving mail will consider part of the body of text header information (until a blank line is reached). This method of implementing ELM for this version allows headers to be added easily and simplified coding by leaving it up to the user to design and compose the header properly but it is not consistent with recent revisions of ELM (ie 3.4) on Unix workstations. NOTE: SendMail does some processing of header information that ELM passes on and adds the date to the header. SendMail attempts to read the IZ environment variable to get the timezone information (defaults to GMT). See SendMail.rx for more details. Setting up Announcer: 1) Edit the variables mailfile, modemport, modemstring, modemringdelay, beeperstring, and beeperdelay as needed in the top of Announcer.rx, see Announcer.rx for details. chose the user "robot" for Announcer to use on my system. Announcer deletes the mail file after processing it so be sure you don't use YOUR mailbox! Edit the file Announcer. commands in your TCPIP: directory to include the programs you want Announcer to be able to run. You must have the SPEAK: device mounted in order to have the PAGE and PAGEMESSAGE functions work. You must have either AmigaNOS or a cron type program run Announcer periodically. I suppose you could have it run continuously and putting a wait delay in the AREXX program but I chose not do do it on my system. To have AmigaNOS execute Announcer once every five minutes you would put the following two lines in your nos-startup: amiga interval 300 amiga command rx TCPIP :Announcer .rx Using Announcer: 1) Announcer commands are placed on the subject line and sent to the user configured in the mailfile variable in Announcer.rx, it currently supports the following commands: PAGE {message} Uses the Amiga's narrator device (via SPEAK: ) to "say" the text on the subject line. If the optional message is not provided, the PAGE command will use the from line to make the announcement . PAGEMESSAGE Like PAGE but uses the body of the message to figure out what to "say". The text to be spoken should follow a line which contains only [START]. The text will be spoken up until a line which contains only [END]. PHONEHOME Uses the information in the configuration variables and your modem to dial a phone number and then hang up after a variable amount of time. BEEPER Like PHONE HOME except it dials the number of a personal pager or beeper and sends a message to display. RUN program Checks Announcer. commands to see of "program" is in the list of programs Announcer is permitted to run and then executes the program. Announcer then waits for that program to return control. After processing successfully the commands in the mail file, Announcer deletes the file so that the commands will not be run again. Announcer keeps a log of the commands it processes and reports any errors. This information is stored in TCPIP: Announcer. log and is created if it does not exist or appended to if it does. The possibilities are endless for a program like Announcer, hopefully these commands are a good start for ideas of your own. Got something cool you did with it? Let me know, I'd like to hear from you .